home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / misc / emu / ATUtilities.lha / ATUtilities / HelpText / atlib.txt < prev    next >
Text File  |  2000-09-26  |  28KB  |  920 lines
  1. #page 000
  2.  
  3. Die ATUtilities-Library:
  4.  
  5. Inhaltsübersicht  --  Teil 1:
  6.  
  7.  Seite 10:   GetOpalFont()()
  8.  Seite 20:   ExitWarning()()
  9.  Seite 30:   ErrorRequest(errorNum) (d0)
  10.  Seite 40:   InfoRequest(info) (a0)
  11.  Seite 50:   MultiRequest(info1,info2,positive,negative) (a0/a1/a2/a3)
  12.  Seite 60:   CallUtility(name) (a0)
  13.  
  14.  Seite 70:  (Funktionen nur für ATKeyboard sinnvoll)
  15.     CreateUtilityList()()
  16.     DeleteUtilityList()()
  17.     CallUtilityList()()
  18.  
  19.  Seite 80:   CreatePublicHandler(jIntNum) (d0)
  20.  Seite 90:   DeletePublicHandler(handler) (a0)
  21. #next 001 Inhalt (2)
  22. #goto 002 Inhalt (3)
  23. #goto 003 Inhalt (4)
  24. #page 001
  25.  
  26. Inhaltsübersicht  --  Teil 2:
  27.  
  28.  Seite 100:   AllocCommMemory()
  29.  Seite 110:   FreeCommMemory()
  30.  Seite 120:   DrawPBorder(win,leftEdge,topEdge,width,height) (a0,d0/d1/d2/d3)
  31.  Seite 130:   DrawNBorder(win,leftEdge,topEdge,width,height) (a0,d0/d1/d2/d3)
  32.  Seite 140:   DrawPTextBorder(win,leftEdge,topEdge,width,height,text) (a0,d0/d1/d2/d3,a1)
  33.  Seite 150:   DrawNTextBorder(win,leftEdge,topEdge,width,height,text) (a0,d0/d1/d2/d3,a1)
  34.  Seite 160:   WriteText(rp,x,y,text) (a0,d0/d1,a1)
  35.  Seite 170:   SelectStdFPen(rp) (a0)
  36.  Seite 180:   SelectStdBPen(rp) (a0)
  37.  Seite 190:   UsePrefs()()
  38.  Seite 200:   CreateStdWindow(title,leftEdge,topEdge,width,height,idcmp,flags) (a0,d0/d1/d2/d3/d4/d5)
  39.  Seite 210:   DeleteStdWindow(window) (a0)
  40.  Seite 220:   CreateBoolGadget(window,leftEdge,topEdge,width,height,text,id) (a0,d0/d1/d2/d3/a1/d4)
  41.  Seite 230:   CreateStringGadget(window,leftEdge,topEdge,width,height,string,maxPos,id)
  42.                                         (a0,d0/d1/d2/d3/a1/d4/d5)
  43.  Seite 240:   CreateNToggleGadget(window,leftEdge,topEdge,width,height,text,id) (a0,d0/d1/d2/d3/a1/d4)
  44.  Seite 250:   CreateSToggleGadget(window,leftEdge,topEdge,width,height,text,id) (a0,d0/d1/d2/d3/a1/d4)
  45. #next 002 Inhalt (3)
  46. #goto 001 Inhalt (2)
  47. #goto 003 Inhalt (4)
  48. #page 002
  49.  
  50. Inhaltsübersicht  --  Teil 3:
  51.  
  52.  Seite 260:   CreateIntegerGadget(window,leftEdge,topEdge,width,height,string,maxPos,id)
  53.                                          (a0,d0/d1/d2/d3/a1/d4/d5)
  54.  Seite 270:   DrawCPBorder(win,leftEdge,topEdge,width,height) (a0,d0/d1/d2/d3)
  55.  Seite 280:   DrawCNBorder(win,leftEdge,topEdge,width,height) (a0,d0/d1/d2/d3)
  56.  Seite 290:   DrawCPTextBorder(win,leftEdge,topEdge,width,height,text) (a0,d0/d1/d2/d3,a1)
  57.  Seite 300:   DrawCNTextBorder(win,leftEdge,topEdge,width,height,text) (a0,d0/d1/d2/d3,a1)
  58.  Seite 310:   CreateProcess(function,stack,name,priority) (a0,d0,a1,d1)
  59.  Seite 320:   AvailJanusMem(type) (d0)
  60.  Seite 330:   Utility(name,type) (a0,d0)
  61.  Seite 340:   Received(port) (a0)
  62.  Seite 350:   InformationBox(title,t1,t2,t3,t4,iconName) (a0,d0/d1/d2/d3/d4)
  63.  Seite 360:   LibraryInfo()()
  64.  Seite 370:   CreatePrivateHandler(jIntNum,size) (d0/d1)
  65.  Seite 380:   DeletePrivateHandler(handler) (a0)
  66.  Seite 390:   ConvertDateStamp(dateStamp,newDateStamp) (a0/a1)
  67.  Seite 400:   ConvertIntelMotorola(longword) (d0)
  68.  Seite 410:   CreateAppItem(title) (a0)
  69.  Seite 420:   DeleteAppItem(app) (a0)
  70. #next 003 Inhalt (4)
  71. #goto 000 Inhalt (1)
  72. #goto 002 Inhalt (3)
  73. #page 003
  74.  
  75. Inhaltsübersicht  --  Teil 4:
  76.  
  77.  Seite 430:   ChangeTaskPri(priority) (d0)
  78.  Seite 440:   Help(helpName,page) (a0,d0)
  79.  Seite 450:   CreateMinGadget(window,leftEdge,topEdge,width,height,id) (a0,d0/d1/d2/d3/d4)
  80. #next 010 GetOpalFont()
  81. #goto 000 Inhalt (1)
  82. #goto 001 Inhalt (2)
  83. #goto 002 Inhalt (3)
  84. #page 010
  85.  
  86. struct TextFont *GetOpalFont()        _LVOGetOpalFont=-30
  87.  
  88. Diese Funktion liefert einen Zeiger auf den Opal/9-Font zurück. Dazu muß
  89. jedoch die Diskfont-Library und der Font verfügbar sein.
  90. #next 020 ExitWarning()
  91. #goto 000 Inhalt (1)
  92. #goto 001 Inhalt (2)
  93. #goto 002 Inhalt (3)
  94. #goto 003 Inhalt (4)
  95. #page 020
  96.  
  97. BOOL ExitWarning()       _LVOExitWarning=-36
  98.  
  99. Diese Funktion öffnet einen Requester mit folgendem Text:
  100.  
  101. Warnung: Das Beenden dieses ATUtilities
  102. kann Probleme erurschen, wenn MS-DOS
  103. einen erneuten Zugriffsversuch macht!
  104. Nach Beendigung sollte ein Reset der
  105. PC/AT-Karte gemacht werden.
  106. Wollen Sie wirklich beenden?
  107. [Ja, Programmende]     [Nein, zurück]
  108.  
  109. Es wird TRUE zurückgeliefert, wenn "Ja, Programmende" gewählt wurde, sonst
  110. FALSE. Diese Funktion sollte vor dem Beenden von ATUtilities aufgerufen werden,
  111. wenn das zugehörige PC-Programm eine Beendigung nicht automatisch erkennt.
  112. #next 030 ErrorRequest()
  113. #goto 000 Inhalt (1)
  114. #goto 001 Inhalt (2)
  115. #goto 002 Inhalt (3)
  116. #goto 003 Inhalt (4)
  117. #page 030
  118.  
  119. VOID ErrorRequest(errorNum)        _LVOErrorRequest=-42
  120.  D0:  ULONG errorNum
  121.  
  122. Diese Funktion gibt den Text eines ATUtilities-Fehlers aus. Fehlernummern:
  123.  
  124.     0 (ERROR_JANUS): "Fehler beim öffnen der Janus-Library."
  125.     1 (ERROR_DISKFONT): "Fehler beim öffnen der DiskFont-Library."
  126.     2 (ERROR_OPAL): "Fehler beim Laden des Opal-Fonts."
  127.     3 (ERROR_MENU): "Fehler bei der Menü-Installation."
  128.     4 (ERROR_ALLOC): "Nicht genug freier Speicher."
  129.     5 (ERROR_SIGNAL): "Nicht genug freie Task-Signale."
  130.     6 (ERROR_SETUP): "Janus-Interrupt ist schon belegt!."
  131.     7 (ERROR_JALLOC): "Nicht genug freier DualPorted-Speicher."
  132.     8 (ERROR_PORT): "Kann Message-Port nicht erstellen."
  133.     9 (ERROR_MPORT): "Kann Port für Utility-Manager nicht erstellen."
  134. 10000 (ERROR_UNDEF): "ATUtilities: Undefinirter Fehler."
  135. #next 040 InfoRequest()
  136. #goto 000 Inhalt (1)
  137. #goto 001 Inhalt (2)
  138. #goto 002 Inhalt (3)
  139. #goto 003 Inhalt (4)
  140. #page 040
  141.  
  142. VOID InfoWarning(info)        _LVOInfoRequest=-48
  143.  A0: UBYTE *info
  144.  
  145. Diese Funktion gibt einen beliebigen einzeiligen Informationstext in einem
  146. Requester aus. Der Requester wird durch klicken auf ein "Okay"-Gadget beendet.
  147.  
  148. Beispiel:
  149.  InfoRequest("Konnte Screen nicht öffnen!");
  150. #next 050 MultiRequest()
  151. #goto 000 Inhalt (1)
  152. #goto 001 Inhalt (2)
  153. #goto 002 Inhalt (3)
  154. #goto 003 Inhalt (4)
  155. #page 050
  156.  
  157. BOOL MultiRequest(info1,info2,positiv,negativ)        _LVOMultiRequest=-54
  158.  A0: UBYTE *info1;
  159.  A1: UBYTE *info2;
  160.  A2: UBYTE *positiv;
  161.  A3: UBYTE *negativ;
  162.  
  163. Diese Funktion öffnet einen zweizeiligen Multifunktionsrequester.
  164. "positiv" gibt den Text für das erste Gadget an, "negativ" den Text für das
  165. Zweite. Ist "negativ" Null, so ist "negativ" gleich "positiv". MultiRequest()
  166. gibt das Ergebnis der Abfrage als Boolean-Wert zurück: TRUE für Wahl von
  167. "positiv", FALSE für "negativ".
  168.  
  169. Beispiele:
  170.  bool=MultiRequest("Wählen Sie bitte:","Rechts oder Links","Rechts","Links");
  171.  MultiRequest("Fehler:","Konnte Screen nicht öffnen!","Okay",NULL);
  172. #next 060 CallUtility()
  173. #goto 000 Inhalt (1)
  174. #goto 001 Inhalt (2)
  175. #goto 002 Inhalt (3)
  176. #goto 003 Inhalt (4)
  177. #page 060
  178.  
  179. VOID CallUtility(name)        _LVOCallUtility=-60
  180.  A0: UBYTE *name
  181.  
  182. Diese Funktion ruft das Utility mit dem Portnamen "name" auf. Sollte es (noch)
  183. nicht laufen, so erscheint folgender Requester:
  184.  
  185. Externe Erweiterung ist (noch) nicht aktiv:
  186. (( Name des Ports ))
  187.  
  188. Ansonsten öffnet das Utility das Einstellungsfenster.
  189. #next 070 ATKeyboard-F.
  190. #goto 000 Inhalt (1)
  191. #goto 001 Inhalt (2)
  192. #goto 002 Inhalt (3)
  193. #goto 003 Inhalt (4)
  194. #page 070
  195.  
  196. Achtung:
  197.  Diese Funktionen sind nur für ATKeyboard sinnvoll. Sie sollten nicht
  198.  in anderen Programmen verwendet werden!
  199.  
  200.  
  201. struct MenuItem *CreateUtilityList()        _LVOCreateUtilityList=-66
  202.  Diese Funktion erstellt die Untermenüs von "Externe Erweiterungen".
  203.  
  204. VOID DeleteUtilityList()        _LVODeleteUtilityList=-72
  205.  Der belegte Speicher für die Untermenüs wird freigeben.
  206.  
  207. VOID CallUtilityList(nummer)        _LVOCallUtilityList=-78
  208.  D0: ULONG nummer
  209.  Ein Untermenü wurde angewählt. Die ATUtilities-Library soll nun auf das
  210.  Sub-Item "nummer" reagieren.
  211.  
  212. #next 080 CreatePublicHandler
  213. #goto 000 Inhalt (1)
  214. #goto 001 Inhalt (2)
  215. #goto 002 Inhalt (3)
  216. #goto 003 Inhalt (4)
  217. #page 080
  218.  
  219. struct ExtendedSetupSig *CreatePublicHandler(jIntNum)        _LVOCreatePublicHandler=-84
  220.  D0: UBYTE jIntNum
  221.  
  222. Diese Funktion erstellt einen Janus-Interrupt-Handler für Janus-Interrupt
  223. "jIntNum". Außer der Interrupt-Belegung wird auch noch ein 16 KByte
  224. großer Speicherbereich (CommMemory) für die Kommunikation bereitgestellt
  225. und ein Signal-Bit für Wait() belegt.
  226. Das CommMemory wird von allen mit CreatePublicHandler() belegten Janus-Interrupts
  227. gemeinsam benutzt, da der PC nicht Multitaskingfähig ist. Soll der Interrupt
  228. den Speicher nur für sich alleine haben, so benutzen Sie CreatePrivateHandler().
  229.  
  230. ExtendedSetupSig:
  231.  00 UWORD Offset  -  Offset auf CommMemory
  232.  02 struct SetupSig *SetupSig  -  Zeiger auf SetupSig
  233.  06 ULONG JanusSignal  -  Signalbit
  234.  10 ULONG JanusSignalMask  -  Signalmaske für Wait()
  235.  14 UBYTE *ByteAccess  -  Zeiger auf CommMemory mit Bytezugriff (MEM_BYTEACCESS)
  236.  18 UWORD *WorkAccess  -  Zeiger auf CommMemory mit Wordzugriff (MEM_WORDACCESS)
  237.  
  238. Weitere Informationen zum CommMemory siehe AllocCommMemory() auf Seite 100.
  239.  
  240. #next 090 DeletePublicHandler()
  241. #goto 000 Inhalt (1)
  242. #goto 001 Inhalt (2)
  243. #goto 002 Inhalt (3)
  244. #goto 003 Inhalt (4)
  245. #page 090
  246.  
  247. VOID DeletePublicHandler(handler)        _LVODeletePublicHandler=-90
  248.  A0: struct ExtendedSetupSig *handler
  249.  
  250. Diese Funktion gibt einen mit CreatePublicHandler() belegten Janus-Interrupt
  251. wieder frei. Wurden alle Janus-Interrupts, die CommMemory benutzten, freigegeben,
  252. so wird auch dieses deallokiert.
  253. #next 100 AllocCommMemory()
  254. #goto 000 Inhalt (1)
  255. #goto 001 Inhalt (2)
  256. #goto 002 Inhalt (3)
  257. #goto 003 Inhalt (4)
  258. #page 100
  259.  
  260. struct CommMemory *AllocCommMemory()        _LVOAllocCommMemory=-96
  261.  
  262. Diese Funktion belegt 16 KBytes für den CommMemory-Speicherbereich. Dieser
  263. Speicherbereich wird im Buffer-RAM belegt - auf PC-Seite liegt dieser
  264. Bereich bei der AT-Karte ab Segment $D400. Der zurückgelieferte Zeiger
  265. hat den Zugriffstyp MEM_WORDACCESS.
  266.  
  267. CommMemory:
  268.      0 UBYTE Memory[16384]  -  16 KBytes für Daten
  269.  16384 UWORD Arg1  -  Argument 1 - normalerweise Kommando
  270.  16386 UWORD Arg2  -  Argument 2
  271.  16388 UWORD Arg3  -  Argument 3
  272.  16390 UWORD Arg4  -  Argument 4
  273.  16392 UWORD Arg5  -  Argument 5
  274.  16394 UWORD Arg6  -  Argument 6
  275.  16396 UWORD Arg7  -  Argument 7
  276.  16398 UWORD Arg8  -  Argument 8
  277. #next 110 FreeCommMemory()
  278. #goto 000 Inhalt (1)
  279. #goto 001 Inhalt (2)
  280. #goto 002 Inhalt (3)
  281. #goto 003 Inhalt (4)
  282. #page 110
  283.  
  284. VOID FreeCommMemory()       _LVOFreeCommMemory=-102
  285.  
  286. Dieser Befehl gibt die Zugriffsberechtigung für den CommMemory-Bereich
  287. wieder zurück. Haben alle Programme, die AllocCommMemory aufgerufen haben,
  288. dies getan, so wird der Speicher freigegeben.
  289. #next 120 DrawPBorder()
  290. #goto 000 Inhalt (1)
  291. #goto 001 Inhalt (2)
  292. #goto 002 Inhalt (3)
  293. #goto 003 Inhalt (4)
  294. #page 120
  295.  
  296. VOID DrawPBorder(window,x,y,länge,höhe)        _LVODrawPBorder=-108
  297.  A0: struct Window *window
  298.  D0: UWORD x
  299.  D1: UWORD y
  300.  D2: UWORD länge
  301.  D3: UWORD höhe
  302.  
  303. Dieser Befehl zeichnet im Fenster "window" einen nach außen gedrückten
  304. Gadget-Rahmen. "x" und "y" geben die Startposition an, "länge" und "höhe"
  305. die Länge und Höhe.
  306. #next 130 DrawNBorder()
  307. #goto 000 Inhalt (1)
  308. #goto 001 Inhalt (2)
  309. #goto 002 Inhalt (3)
  310. #goto 003 Inhalt (4)
  311. #page 130
  312.  
  313. VOID DrawNBorder(window,x,y,länge,höhe)        _LVODrawNBorder=-114
  314.  A0: struct Window *window
  315.  D0: UWORD x
  316.  D1: UWORD y
  317.  D2: UWORD länge
  318.  D3: UWORD höhe
  319.  
  320. Dieser Befehl zeichnet im Fenster "window" einen nach innen gedrückten
  321. Gadget-Rahmen. "x" und "y" geben die Startposition an, "länge" und "höhe"
  322. die Länge und Höhe.
  323. #next 140 DrawPTextBorder()
  324. #goto 000 Inhalt (1)
  325. #goto 001 Inhalt (2)
  326. #goto 002 Inhalt (3)
  327. #goto 003 Inhalt (4)
  328. #page 140
  329.  
  330. VOID DrawPTextBorder(window,x,y,länge,höhe,text)        _LVODrawPTextBorder=-120
  331.  A0: struct Window *window
  332.  D0: UWORD x
  333.  D1: UWORD y
  334.  D2: UWORD länge
  335.  D3: UWORD höhe
  336.  A1: UBYTE *text
  337.  
  338. Dieser Befehl zeichnet im Fenster "window" einen nach außen gedrückten
  339. Gadget-Rahmen. "x" und "y" geben die Startposition an, "länge" und "höhe"
  340. die Länge und Höhe. Danach wird in diesem Bereich der Text "text" zentriert
  341. ausgegeben.
  342.  
  343. #next 150 DrawNTextBorder()
  344. #goto 000 Inhalt (1)
  345. #goto 001 Inhalt (2)
  346. #goto 002 Inhalt (3)
  347. #goto 003 Inhalt (4)
  348. #page 150
  349.  
  350. VOID DrawNTextBorder(window,x,y,länge,höhe,text)        _LVODrawNTextBorder=-126
  351.  A0: struct Window *window
  352.  D0: UWORD x
  353.  D1: UWORD y
  354.  D2: UWORD länge
  355.  D3: UWORD höhe
  356.  A1: UBYTE *text
  357.  
  358. Dieser Befehl zeichnet im Fenster "window" einen nach innen gedrückten
  359. Gadget-Rahmen. "x" und "y" geben die Startposition an, "länge" und "höhe"
  360. die Länge und Höhe. Danach wird in diesem Bereich der Text "text" zentriert
  361. ausgegeben.
  362. #next 160 WriteText()
  363. #goto 000 Inhalt (1)
  364. #goto 001 Inhalt (2)
  365. #goto 002 Inhalt (3)
  366. #goto 003 Inhalt (4)
  367. #page 160
  368.  
  369. VOID WriteText(rastPort,x,y,text)        _LVOWriteText=-132
  370.  A0: struct RastPort *rastPort
  371.  D0: UWORD x
  372.  D1: UWORD y
  373.  A1: UBYTE *text
  374.  
  375. Dieser Befehl gibt im Rast-Port "rastPort" einen Text an der Position
  376. "x","y" aus.
  377. #next 170 SelectStdFPen()
  378. #goto 000 Inhalt (1)
  379. #goto 001 Inhalt (2)
  380. #goto 002 Inhalt (3)
  381. #goto 003 Inhalt (4)
  382. #page 170
  383.  
  384. VOID SelectStdFPen(rastPort)       _LVOSelectStdFPen=-138
  385.  A0: struct RastPort *rastPort
  386.  
  387. Dieser Befehl setzt die Vordergrundzeichenfarbe des Rast-Port "rastPort"
  388. auf den Standardwert für die jeweilige Betriebssystemversion.
  389. #next 180 SelectStdBPen()
  390. #goto 000 Inhalt (1)
  391. #goto 001 Inhalt (2)
  392. #goto 002 Inhalt (3)
  393. #goto 003 Inhalt (4)
  394. #page 180
  395.  
  396. VOID SelectStdBPen(rastPort)       _LVOSelectStdBPen=-144
  397.  A0: struct RastPort *rastPort
  398.  
  399. Dieser Befehl setzt die Hintergrundzeichenfarbe des Rast-Port "rastPort"
  400. auf den Standardwert für die jeweilige Betriebssystemversion.
  401. #next 190 UsePrefs()
  402. #goto 000 Inhalt (1)
  403. #goto 001 Inhalt (2)
  404. #goto 002 Inhalt (3)
  405. #goto 003 Inhalt (4)
  406. #page 190
  407.  
  408. BOOL UsePrefs()        _LVOUsePrefs=-150
  409.  
  410. Diese Funktion öffnet folgenden Requester:
  411.  
  412. Wollen Sie die gemachten Einstellungen
  413. Übernehmen oder verwerfen ?
  414. [Übernehmen]          [Verwerfen]
  415.  
  416. Bei Übernehmen wird TRUE zurückgeliefert, sonst FALSE.
  417. #next 200 CreateStdWindow()
  418. #goto 000 Inhalt (1)
  419. #goto 001 Inhalt (2)
  420. #goto 002 Inhalt (3)
  421. #goto 003 Inhalt (4)
  422. #page 200
  423.  
  424. struct Window *CreateStdWindow(titel,x,y,breite,höhe,IDCMP,flags)    _LVOCreateStdWindow=-156
  425.  A0: UBYTE *titel
  426.  D0: UWORD x
  427.  D1: UWORD y
  428.  D2: UWORD breite
  429.  D3: UWORD höhe
  430.  D4: ULONG IDCMP
  431.  D5: ULONG flags
  432.  
  433. Diese Funktion öffnet ein Fenster an der Position "x","y" mit "breite" Pixel
  434. Breite und "höhe" Pixel Höhe. "flags" gibt die Window-Flags an, "IDCMP" die
  435. zu sendenden Ereignisse.
  436. Für die Gadget-Funktionen wird der Eintrag "UserData" auf Null gesetzt.
  437. Er nimmt später eine Remember-Struktur auf.
  438. #next 210 DeleteStdWindow()
  439. #goto 000 Inhalt (1)
  440. #goto 001 Inhalt (2)
  441. #goto 002 Inhalt (3)
  442. #goto 003 Inhalt (4)
  443. #page 210
  444.  
  445. VOID DeleteStdWindow(fenster)      _LVODeleteStdWindow=-162
  446.  A0: struct Window *fenster
  447.  
  448. Diese Funktion schließt ein mit CreateStdWindow() geöffnetes Fenster.
  449. Sind Remember-Einträge vorhanden, so werden sie freigegeben.
  450. #next 220 CreateBoolGadget()
  451. #goto 000 Inhalt (1)
  452. #goto 001 Inhalt (2)
  453. #goto 002 Inhalt (3)
  454. #goto 003 Inhalt (4)
  455. #page 220
  456.  
  457. struct Gadget *CreateBoolGadget(fenster,x,y,breite,höhe,text,id)      _LVOCreateBoolGadget=-168
  458.  A0: struct Window *fenster
  459.  D0: UWORD x
  460.  D1: UWORD y
  461.  D2: UWORD breite
  462.  D3: UWORD höhe
  463.  A1: UBYTE *text
  464.  D4: UWORD id
  465.  
  466. Diese Funktion erstellt im Fenster "window" ein Boolean-Gadget.
  467. "text" gibt den in das Gadget zu zentrierenden Text an, "id" die Kennnummer.
  468. #next 230 CreateStringGadget()
  469. #goto 000 Inhalt (1)
  470. #goto 001 Inhalt (2)
  471. #goto 002 Inhalt (3)
  472. #goto 003 Inhalt (4)
  473. #page 230
  474.  
  475. UBYTE *CreateStringGadget(fenster,x,y,breite,höhe,text,maxPos,id)      _LVOCreateStringGadget=-174
  476.  A0: struct Window *fenster
  477.  D0: UWORD x
  478.  D1: UWORD y
  479.  D2: UWORD breite
  480.  D3: UWORD höhe
  481.  A1: UBYTE *text
  482.  D4: UWORD maxPos
  483.  D5: UWORD id
  484.  
  485. Diese Funktion erstellt im Fenster "window" ein String-Gadget.
  486. "text" gibt den voreingestellten Text an, "id" die Kennnummer,
  487. "maxPos" die maximale Anzahl von Zeichen im Gadget.
  488.  
  489. Wichtig:
  490.  CreateStringGadget() gibt einen Zeiger auf den String-Buffer zurück,
  491.  nicht auf die Gadget-Struktur!
  492. #next 240 CreateNToggleGadget()
  493. #goto 000 Inhalt (1)
  494. #goto 001 Inhalt (2)
  495. #goto 002 Inhalt (3)
  496. #goto 003 Inhalt (4)
  497. #page 240
  498.  
  499. struct Gadget *CreateNToggleGadget(fenster,x,y,breite,höhe,text,id)      _LVOCreateNToggleGadget=-180
  500.  A0: struct Window *fenster
  501.  D0: UWORD x
  502.  D1: UWORD y
  503.  D2: UWORD breite
  504.  D3: UWORD höhe
  505.  A1: UBYTE *text
  506.  D4: UWORD id
  507.  
  508. Diese Funktion erstellt im Fenster "window" ein Toggle-Gadget.
  509. "text" gibt den in das Gadget zu zentrierenden Text an, "id" die Kennnummer.
  510. Das Gadget ist nach dem Aufruf dieser Funktion nicht gedrückt.
  511. #next 250 CreateSToggleGadget()
  512. #goto 000 Inhalt (1)
  513. #goto 001 Inhalt (2)
  514. #goto 002 Inhalt (3)
  515. #goto 003 Inhalt (4)
  516. #page 250
  517.  
  518. struct Gadget *CreateSToggleGadget(fenster,x,y,breite,höhe,text,id)      _LVOCreateSToggleGadget=-186
  519.  A0: struct Window *fenster
  520.  D0: UWORD x
  521.  D1: UWORD y
  522.  D2: UWORD breite
  523.  D3: UWORD höhe
  524.  A1: UBYTE *text
  525.  D4: UWORD id
  526.  
  527. Diese Funktion erstellt im Fenster "window" ein Toggle-Gadget.
  528. "text" gibt den in das Gadget zu zentrierenden Text an, "id" die Kennnummer.
  529. Das Gadget ist nach dem Aufruf dieser Funktion gedrückt (SELECTED).
  530. #next 260 CreateIntegerGadget()
  531. #goto 000 Inhalt (1)
  532. #goto 001 Inhalt (2)
  533. #goto 002 Inhalt (3)
  534. #goto 003 Inhalt (4)
  535. #page 260
  536.  
  537.  
  538. UBYTE *CreateIntegrGadget(fenster,x,y,breite,höhe,string,maxPos,id)      _LVOCreateIntegerGadget=-192
  539.  A0: struct Window *fenster
  540.  D0: UWORD x
  541.  D1: UWORD y
  542.  D2: UWORD breite
  543.  D3: UWORD höhe
  544.  A1: UBYTE *string
  545.  D4: UWORD maxPos
  546.  D5: UWORD id
  547.  
  548. Diese Funktion erstellt im Fenster "window" ein Integer-Gadget.
  549. "text" gibt den voreingestellten Text an, "id" die Kennnummer,
  550. "maxPos" die maximale Anzahl von Zeichen im Gadget.
  551. "string" gibt die Vorgabe-Zahl in Textform an:
  552. z. B. "0", "1000".
  553.  
  554. Wichtig:
  555.  CreateIntegerGadget() gibt einen Zeiger auf den String-Buffer zurück,
  556.  nicht auf die Gadget-Struktur!
  557. #next 270 DrawCPBorder()
  558. #goto 000 Inhalt (1)
  559. #goto 001 Inhalt (2)
  560. #goto 002 Inhalt (3)
  561. #goto 003 Inhalt (4)
  562. #page 270
  563.  
  564. VOID DrawCPBorder(window,x,y,länge,höhe)        _LVODrawCPBorder=-198
  565.  A0: struct Window *window
  566.  D0: UWORD x
  567.  D1: UWORD y
  568.  D2: UWORD länge
  569.  D3: UWORD höhe
  570.  
  571. Dieser Befehl zeichnet im Fenster "window" einen nach außen gedrückten
  572. Gadget-Rahmen. "x" und "y" geben die Startposition an, "länge" und "höhe"
  573. die Länge und Höhe. Bevor jedoch der Rahmen gezeichnet wird, wird
  574. der Bereich innerhalb des Rahmens mit Farbe 0 gelöscht.
  575. #next 280 CreateCNBorder()
  576. #goto 000 Inhalt (1)
  577. #goto 001 Inhalt (2)
  578. #goto 002 Inhalt (3)
  579. #goto 003 Inhalt (4)
  580. #page 280
  581.  
  582. VOID DrawCNBorder(window,x,y,länge,höhe)        _LVODrawNPBorder=-204
  583.  A0: struct Window *window
  584.  D0: UWORD x
  585.  D1: UWORD y
  586.  D2: UWORD länge
  587.  D3: UWORD höhe
  588.  
  589. Dieser Befehl zeichnet im Fenster "window" einen nach innen gedrückten
  590. Gadget-Rahmen. "x" und "y" geben die Startposition an, "länge" und "höhe"
  591. die Länge und Höhe. Bevor jedoch der Rahmen gezeichnet wird, wird
  592. der Bereich innerhalb des Rahmens mit Farbe 0 gelöscht.
  593. #next 290 DrawCPTextBorder()
  594. #goto 000 Inhalt (1)
  595. #goto 001 Inhalt (2)
  596. #goto 002 Inhalt (3)
  597. #goto 003 Inhalt (4)
  598. #page 290
  599.  
  600. VOID DrawCPTextBorder(window,x,y,länge,höhe,text)        _LVODrawCPTextBorder=-210
  601.  A0: struct Window *window
  602.  D0: UWORD x
  603.  D1: UWORD y
  604.  D2: UWORD länge
  605.  D3: UWORD höhe
  606.  A1: UBYTE *text
  607.  
  608. Dieser Befehl zeichnet im Fenster "window" einen nach außen gedrückten
  609. Gadget-Rahmen. "x" und "y" geben die Startposition an, "länge" und "höhe"
  610. die Länge und Höhe. Danach wird in diesem Bereich der Text "text" zentriert
  611. ausgegeben. Bevor jedoch der Rahmen gezeichnet wird, wird der Bereich
  612. innerhalb des Rahmens mit Farbe 0 gelöscht.
  613. #next 300 DrawCNTextBorder()
  614. #goto 000 Inhalt (1)
  615. #goto 001 Inhalt (2)
  616. #goto 002 Inhalt (3)
  617. #goto 003 Inhalt (4)
  618. #page 300
  619.  
  620. VOID DrawCNTextBorder(window,x,y,länge,höhe,text)        _LVODrawCNTextBorder=-216
  621.  A0: struct Window *window
  622.  D0: UWORD x
  623.  D1: UWORD y
  624.  D2: UWORD länge
  625.  D3: UWORD höhe
  626.  A1: UBYTE *text
  627.  
  628. Dieser Befehl zeichnet im Fenster "window" einen nach innen gedrückten
  629. Gadget-Rahmen. "x" und "y" geben die Startposition an, "länge" und "höhe"
  630. die Länge und Höhe. Danach wird in diesem Bereich der Text "text" zentriert
  631. ausgegeben. Bevor jedoch der Rahmen gezeichnet wird, wird der Bereich
  632. innerhalb des Rahmens mit Farbe 0 gelöscht.
  633. #next 310 CreateProcess()
  634. #goto 000 Inhalt (1)
  635. #goto 001 Inhalt (2)
  636. #goto 002 Inhalt (3)
  637. #goto 003 Inhalt (4)
  638. #page 310
  639.  
  640. struct Process *CreateProcess(funktion,stack,name,priorität)      _LVOCreateProcess=-222
  641.  A0: VOID (funktion *)()
  642.  D0: ULONG stack
  643.  A1: UBYTE *name
  644.  D1: BYTE priorität
  645.  
  646. Diese Funktion erstellt einen Neuen Prozess. "funktion" ist ein Zeiger
  647. auf die Routine, "stack" die Anzahl der Bytes für den Stack, "name" ein
  648. Zeiger auf den neuen Task-Namen, "priorität" die Task-Priorität.
  649. #next 320 AvailJanusMem()
  650. #goto 000 Inhalt (1)
  651. #goto 001 Inhalt (2)
  652. #goto 002 Inhalt (3)
  653. #goto 003 Inhalt (4)
  654. #page 320
  655.  
  656. UWORD AvailJanusMem(type)       _LVOAvailJanusMem=-228
  657.  D0: UWORD type
  658.  
  659. Diese Funktion ermittelt die Anzahl der freien Bytes eines
  660. Janus-Speicherbereichs.
  661.  
  662. "type":
  663.   Parameter-Speicher: MEMF_PARAMETER=1
  664.   Buffer-Speicher: MEMF_BUFFER=2
  665. #next 330 Utility()
  666. #goto 000 Inhalt (1)
  667. #goto 001 Inhalt (2)
  668. #goto 002 Inhalt (3)
  669. #goto 003 Inhalt (4)
  670. #page 330
  671.  
  672. VOID Utility(name,aktion)       _LVOUtility=-234
  673.  A0: UBYTE *name
  674.  D0: UWORD aktion;
  675.  
  676. Diese Funktion ruft ein Utility mit dem Kommando "aktion" auf.
  677. UTILITY_CALL bewirk das gleiche wie der Befehl CallUtility(). Utility()
  678. kann benutzt werden, um z. B. die Online-Hilfe für ein Utility direkt
  679. aufzurufen.
  680.  
  681.  
  682. Es stehen folgende Kommandos zur verfügung:
  683.   Utility aufrufen (wie CallUtility()):  UTILITY_CALL=50
  684.   Utility beenden:  UTILITY_QUIT=40
  685.   Information über Utility:  UTILITY_INFO=20
  686.   Online-Hilfe für Utility:  UTILITY_HELP=30
  687. #next 340 Received()
  688. #goto 000 Inhalt (1)
  689. #goto 001 Inhalt (2)
  690. #goto 002 Inhalt (3)
  691. #goto 003 Inhalt (4)
  692. #page 340
  693.  
  694. UWORD Received(port)      _LVOReceived=-240
  695.  A0: struct MsgPort *port
  696.  
  697. Diese Funktion wird muß in einem Utility aufgerufen werden, wenn mit Wait()
  698. eine Message am Kommandoport ermittelt wurde. Received() gibt dann die
  699. Kommandonummer zurück, die bei Utility() aufgerufen wurde. Beispiel:
  700.  
  701. Port=Zeiger auf erstellten Kommando-Port, PortSignalMask=(1L<<Port->mp_SigBit);
  702. while(ende==FALSE)
  703.  {
  704.   Signale=Wait(JanusSignalMask+PortSignalMask)
  705.   if(Signale & PortSignalMask)
  706.    {
  707.     cmd=Received(Port);
  708.     switch(cmd)
  709.      {
  710.       case UTILITY_CALL:
  711.         EinstellungenAendern();
  712.        break;
  713.       .......
  714. #next 350 InformationBox()
  715. #goto 000 Inhalt (1)
  716. #goto 001 Inhalt (2)
  717. #goto 002 Inhalt (3)
  718. #goto 003 Inhalt (4)
  719. #page 350
  720.  
  721. VOID InformationBox(titel,t1,t2,t3,t4,iconName)      _LVOInformationBox=-246
  722.  A0: UBYTE *titel
  723.  D0: UBYTE *t1
  724.  D1: UBYTE *t2
  725.  D2: UBYTE *t3
  726.  D3: UBYTE *t4
  727.  D4: UBYTE *iconName
  728.  
  729. Diese Funktion erstellt das Standard-Informationsfenster. "titel" gibt
  730. den Fenstertitel an, "t1" bis "t4" die vier Textzeilen, "iconName" den
  731. Namen des Programm-Icons (ohne ".info" !) oder Null..
  732.  
  733. Beispiel:
  734.  InformationBox("Test-Programm - Information",
  735.                 "Test-Programm - Version 2.0",
  736.                 "Copyright (C) 1995 by",
  737.                 "X. Y.",
  738.                 "All rights reserved",
  739.                 "DH0:Test/TestIcon");
  740. #next 360 LibraryInfo()
  741. #goto 000 Inhalt (1)
  742. #goto 001 Inhalt (2)
  743. #goto 002 Inhalt (3)
  744. #goto 003 Inhalt (4)
  745. #page 360
  746.  
  747. VOID LibraryInfo()        _LVOLibraryInfo=-252
  748.  
  749. Diese Funktion gibt Informationen über die ATUtilities-Library aus.
  750. #next 370 CreatePrivateHandler()
  751. #goto 000 Inhalt (1)
  752. #goto 001 Inhalt (2)
  753. #goto 002 Inhalt (3)
  754. #goto 003 Inhalt (4)
  755. #page 370
  756.  
  757. struct ExtendedSetupSig *CreatePrivateHandler(jIntNum,bytes)      _LVOCreatePrivateHandler=-258
  758.  D0: UBYTE jIntNum
  759.  D1: UWORD bytes
  760.  
  761. Diese Funktion erstellt einen Janus-Interrupt-Handler für Janus-Interrupt
  762. "jIntNum". Als Kommunikationsspeicher werden ihm "bytes" Bytes Buffer-Speicher
  763. zugewiesen.
  764.  
  765. ExtendedSetupSig:
  766.  00 UWORD Offset  -  Offset auf Buffer-Speicher
  767.  02 struct SetupSig *SetupSig  -  Zeiger auf SetupSig
  768.  06 ULONG JanusSignal  -  Signalbit
  769.  10 ULONG JanusSignalMask  -  Signalmaske für Wait()
  770.  14 UBYTE *ByteAccess  -  Zeiger auf Speicher mit Bytezugriff (MEM_BYTEACCESS)
  771.  18 UWORD *WorkAccess  -  Zeiger auf Speicher mit Wordzugriff (MEM_WORDACCESS)
  772.  
  773. #next 380 DeletePrivateHandler()
  774. #goto 000 Inhalt (1)
  775. #goto 001 Inhalt (2)
  776. #goto 002 Inhalt (3)
  777. #goto 003 Inhalt (4)
  778. #page 380
  779.  
  780.  
  781. VOID DeletePrivateHandler(handler)        _LVODeletePrivateHandler=-264
  782.  A0: struct ExtendedSetupSig *handler
  783.  
  784. Diese Funktion gibt einen mit CreatePrivateHandler() belegten Janus-Interrupt
  785. wieder frei.
  786. #next 390 ConvertDateStamp()
  787. #goto 000 Inhalt (1)
  788. #goto 001 Inhalt (2)
  789. #goto 002 Inhalt (3)
  790. #goto 003 Inhalt (4)
  791. #page 390
  792.  
  793. VOID ConvertDateStamp(dateStamp,newDateStamp)      _LVOConvertDateStamp=-270
  794.  A0: struct DateStamp *dateStamp
  795.  A1: struct NewDateStamp *newDateStamp
  796.  
  797. Diese Funktion konvertiert einen DateStamp in eine neue Form, in der alle
  798. Angaben ohne Umrechnung verwendbar sind. "dateStamp" gibt den Date-Stamp an,
  799. "newDateStamp" einen Speicherbereich, in dem die neuen Angaben gesichert
  800. werden sollen.
  801.  
  802. NewDateStamp:
  803.   0 UBYTE Hour  -  Stunde
  804.   1 UBYTE Minute  -  Minute
  805.   2 UBYTE Second  -  Sekunde
  806.   3 UBYTE DayNum  -  Wochentag (0=Sonntag, 1=Montag usw.)
  807.   4 UBYTE Day  -  Tag
  808.   5 UBYTE Month  -  Monat
  809.   6 UWORD Year  -  Jahr
  810. #next 400 ConvertIntelMotorola()
  811. #goto 000 Inhalt (1)
  812. #goto 001 Inhalt (2)
  813. #goto 002 Inhalt (3)
  814. #goto 003 Inhalt (4)
  815. #page 400
  816.  
  817. ULONG ConvertIntelMotorola(longword)      _LVOConvertIntelMotorola=-276
  818.  D0: ULONG longword
  819.  
  820. Diese Funktion konvertiert ein Langword zwischen Intel-Prozessoren und
  821. Motorola-Prozessoren. Ein Intel-Langword kann so ins Dual Ported RAM
  822. geschrieben werden, vom Amiga mit Wordzugriff ausgelesen und mit
  823. ConvertIntelMotorola() zum Amiga-Langword konvertiert werden und umgekehrt.
  824.  
  825. Dabei werden die oberen 16 Bit mit den Unteren 16 Bit vertauscht.
  826.  
  827. #next 410 CreateAppItem()
  828. #goto 000 Inhalt (1)
  829. #goto 001 Inhalt (2)
  830. #goto 002 Inhalt (3)
  831. #goto 003 Inhalt (4)
  832. #page 410
  833.  
  834. struct AppManager *CreateAppItem(titel)      _LVOCreateAppItem=-282
  835.  A0: UBYTE *titel
  836.  
  837. Diese Funktion erzeugt ein neues App-Item mit dem Titel "titel". Sie wird
  838. jedoch nur ausgeführt, wenn Amiga-DOS 2.0 vorhanden ist. Es wird ein Zeiger
  839. auf folgende Struktur zurückgegeben:
  840.  
  841. AppManager:
  842.   0 struct MsgPort *Port  -  Zeiger auf Message-Port für App-Item
  843.   4 ULONG SignalMask  -  Signal-Maske für Wait
  844.   8 APTR AppItem  -  Zeiger auf App-Item
  845.  
  846. Durch den Message-Port oder dessen Signal-Mask kann auf die Anwahl des Items
  847. gewartet werden. Ist eine Message angekommen, so muß sie mit GetMsg() geholt
  848. und dann durch ReplyMsg() zurückgegeben werden. Beispiel:
  849.  
  850.  Signale=Wait(..);
  851.  if(Signale & AppManager->SignalMask) {
  852.    ReplyMsg(GetMsg(AppManager->Port));
  853.    ... }
  854. #next 420 DeleteAppItem()
  855. #goto 000 Inhalt (1)
  856. #goto 001 Inhalt (2)
  857. #goto 002 Inhalt (3)
  858. #goto 003 Inhalt (4)
  859. #page 420
  860.  
  861. VOID DeleteAppItem(appManager)        _LVODeleteAppItem=-288
  862.  A0: struct AppManager *appManager
  863.  
  864. Ein mit CreateAppItem() erstelltes App-Item wird wieder entfernt.
  865. #next 430 ChangeTaskPri()
  866. #goto 000 Inhalt (1)
  867. #goto 001 Inhalt (2)
  868. #goto 002 Inhalt (3)
  869. #goto 003 Inhalt (4)
  870. #page 430
  871.  
  872. VOID ChangeTaskPri(pri)       _LVOChangeTaskPri=-294
  873.  D0: BYTE pri
  874.  
  875. Die Priorität des aktuellen Tasks wird auf "pri" gesetzt.
  876. #next 440 Help()
  877. #goto 000 Inhalt (1)
  878. #goto 001 Inhalt (2)
  879. #goto 002 Inhalt (3)
  880. #goto 003 Inhalt (4)
  881. #page 440
  882.  
  883. VOID Help(name,seite)        _LVOHelp=-300
  884.  A0: UBYTE *name
  885.  D0: UWORD seite
  886.  
  887. Diese Funktion ruft die Online-Hilfe mit der Hilfedatei "name" auf.
  888. Es wird Seitennummer "seite" angezeigt.
  889.  
  890. Anmerkung:
  891.   Das gesamte Online-Hilfe-System befindet sich in die ATUtilities-Library,
  892.   so daß es immer verfügbar ist.
  893.  
  894.  Textdateien werden mit dem Programm "hc" im Help-Verzeichnis in Hilfedateien
  895.  übersetzt. Die Datei hc.txt im gleichen Verzeichnis enthält dazu weitere
  896.  Informationen.
  897. #next 450 CreateMinGadget()
  898. #goto 000 Inhalt (1)
  899. #goto 001 Inhalt (2)
  900. #goto 002 Inhalt (3)
  901. #goto 003 Inhalt (4)
  902. #page 450
  903.  
  904. struct Gadget *CreateMinGadget(win,x,y,breite,höhe,id)      _LVOCreateMinGadget=-306
  905.  A0: struct Window *fenster
  906.  D0: UWORD x
  907.  D1: UWORD y
  908.  D2: UWORD breite
  909.  D3: UWORD höhe
  910.  D4: UWORD id
  911.  
  912. Diese Funktion erstellt im Fenster "window" ein Boolean-Gadget. Dazu wird
  913. aber kein Rahmen gezeichnet! Durch das GADGHNONE-Flag wird eine invertierung
  914. des Gadget-Bereichs bei Anwahl unterbunden.
  915. #next 000 Inhalt (1)
  916. #goto 001 Inhalt (2)
  917. #goto 002 Inhalt (3)
  918. #goto 003 Inhalt (4)
  919. #end
  920.